CALLNUM() (INTEGER)

 Function
  Returns the current caller number.

 Syntax
  CALLNUM()   No arguments are required

 Return Type & Value
  INTEGER
  Returns the caller number of the user online.

 Remarks
  Everytime a user logs on to the system the system caller number is
  incremented.  This function will return the caller number for use in
  your PPL applications.  It is kept in the main conference MSGS file.

  Note that the number is not incremented until after the user has
  completely logged on to the system so you should generally wait until
  LOGGEDON() reports TRUE before using this function.

 Examples
  IF (LOGGEDON() & (CALLNUM() = 1000000)) THEN
    PRINTLN "@BEEP@CONGRATULATIONS!!!"
    PRINTLN "@BEEP@YOU ARE THE 1,000,000th CALLER!!!"
    PRINTLN "Upgrading security . . ."
    GETUSER
    LET U_SEC = 99
    PUTUSER
  ENDIF